home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 011-020 / amok13 / compcontrol / compcontrol.doc < prev    next >
Text File  |  1993-11-04  |  8KB  |  194 lines
  1.  
  2.  
  3.  
  4.                                   CompControl
  5.                                   Version 2.1
  6.                       Der SoftWareArmy-Compiler-Controller
  7.                                 von Ralf Kaiser
  8.  
  9. Der SwA-Compiler-Controller ist ein Programm, das die Bedienung von
  10. Editor, Compiler und Linker vereinfacht. Das Programm liest die Namen
  11. der jeweils zu startenden Programme aus einem Konfigurationsfile. Dadurch
  12. kann sich jeder Anwender die Konfiguration einstellen, die seinem
  13. System entspricht.
  14.  
  15. - Aufruf des Programms 
  16.  
  17.   CompControl <Workname>
  18.   
  19. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  20. !                                                                           !
  21. ! Das Starten von der Workbench funktioniert in dieser Version leider       !
  22. ! nicht. Die Programme (also Editor u.s.w), die aufgerufen werden, arbeiten !
  23. ! bei einem Workbenchstart nicht !!                                         !
  24. ! Warum das so ist, kann ich noch nicht sagen, ich habe jedenfalls          !
  25. ! Terminal IMPORTiert und somit ein Fenster für Ein- und Ausgabe zur Ver-   !
  26. ! fügung. Wenn jemand weiß, warum das so ist : Ich brauch dringend (!!)     !
  27. ! eine Antwort auf das Problem.                                             !
  28. ! Allerdings ist der CompControl bei der Arbeit mit der WB auch nicht       !
  29. ! so nötig wie bei der Arbeit mit dem CLI.                                  !
  30. !                                                                           !
  31. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  32.  
  33.   Das Argument <Workname> ist optional. Wird es angegeben, so wird es
  34.   automatisch in das Namensgadget eingetragen und als Arbeitsname
  35.   benutzt.
  36.  
  37. - Die Konfiguration
  38.  
  39.   Der CompControl liest beim Aufstarten ein Konfigurationsfile. Das File hat
  40.   den Namen "CC.Config" und sollte entweder im aktuellen Directory oder
  41.   in "S:" vorhanden sein. Ist das File nicht vorhanden, so gelten für die
  42.   Konfiguration festgelegte Standardwerte.
  43.   Bei der Konfiguration kann man als "Compiler" 2 verschiedene Programme
  44.   einsetzen. Jedem "Compiler" wird noch eine Endung zugeordnet, die an
  45.   das mit diesem "Compiler" bearbeitete Programm angehängt wird.
  46.   Zwei Beispiele sollen das verdeutlichen :
  47.   
  48.   1. Als 1.Compiler wird "C:M2C " eingesetzt. Die Endung lautet ".MOD".
  49.      Als 2.Compiler wird "C:M2C " eingesetzt. Die Endung lautet ".DEF".
  50.   
  51.   2. Als 1.Compiler wird "C:CC " eingesetzt. Die Endung lautet ".C".
  52.      Als 2."Compiler" wird "C:AS " eingesetzt. Die Endung lautet ".ASM".
  53.   
  54.   Dadurch ist es nun möglich mit dem CompControl nebenbei noch ein
  55.   anderes Programm zu betreiben (wie in dem Beispiel ein Assembler).
  56.   
  57.   Beim Format des Konfigurationsfiles ist die Reihenfolge der einzelnen
  58.   Komponenten zwingend vorgeschrieben. Das File besteht aus folgenden
  59.   Zeilen :
  60.   
  61.   1. Zeile : Pfad, Name und Optionen für den Editor
  62.              Beispiel : "C:M2EMACS -d "
  63.   2. Zeile : Pfad, Name und Optionen für den Compiler 1
  64.              Beispiel : "C:M2C -di "
  65.   3. Zeile : Endung des Arbeitsfiles für Compiler 1
  66.              Beispiel : ".MOD"
  67.   4. Zeile : Pfad, Name und Optionen für den Compiler 2
  68.              Beispiel : "C:M2C -di "
  69.   5. Zeile : Endung des Arbeitsfiles für Compiler 2
  70.              Beispiel : ".DEF"
  71.   6. Zeile : Pfad, Name und Optionen für den Linker
  72.              Beispiel : "C:M2L "
  73.   7. Zeile : Endung des Arbeitsfiles für den Linker
  74.   
  75.   Das Konfigurationsfile kann mit einem beliebigen Texteditor eingegeben
  76.   werden. Die Zeilen werden jeweils ohne die Anführungsstriche eingegeben.
  77.   Dabei ist es wichtig, daß die Zeilen 1, 2, 4 und 6 jeweils mit einem
  78.   SPACE enden.
  79.   Die Standardkonfiguration, also diejenige die bei Fehlen des Files
  80.   eingesetzt wird, ist genau die aus den Beispielen.
  81.   
  82.   
  83. - Die Gadgets
  84.   
  85.   Der CompControl stellt insgesammt 12 Gadgets für die Arbeit zur
  86.   Verfügung. Auf diese Gadgets und deren Bedeutung soll nun im 
  87.   einzelnen eingegangen werden.
  88.  
  89.   Edit
  90.   Mit dem Editgadget wird der eingestellte Editor aufgerufen. Als Argument
  91.   wird der aktuelle Arbeitsname sowie die aktuelle Endung uebergeben.
  92.  
  93.   Kompillieren
  94.   Mit dem Compilergadget wird der aktuelle Compiler aufgerufen. Das Programm
  95.   übergiebt wieder den Arbeitsnamen und die aktuelle Endung.
  96.   
  97.   Binden
  98.   Mit dem Linkgadget wird der Linker aufgerufen. Er bekommt als Argument
  99.   wieder den Arbeitsnamen sowie die Linkerendung (meistens .OBJ)
  100.  
  101.   Starten
  102.   Über dieses Gadget wird das vom Linker erzeugte Programm gestartet.
  103.  
  104.   Name
  105.   Unter der ersten Reihe Gadgets befindet sich ein Stringgadget, in das
  106.   der Arbeitsname eingetragen werden kann. Man trägt einfach nur den
  107.   Namen des zu bearbeitenden Programms ein, also ohne jede Endung.
  108.   
  109.   alles zusammen ...
  110.   Wird dieses Gadget gewählt, ruft das Programm hintereinander den Compiler
  111.   und den Linker auf und startet dann das erzeugte Programm.
  112.  
  113.   Endung 1
  114.   Über dieses Gadget wird die Endung die als erstes in der Konfigurations-
  115.   liste steht zur aktuellen Endung erklärt.
  116.  
  117.   Endung 2
  118.   Über dieses Gadget wird die Endung die als zweites in der Konfigurations-
  119.   liste steht zur aktuellen Endung erklärt.
  120.  
  121.   Kommando
  122.   Mit dem Kommandogadget wird ein neues CLI-Fenster auf der Workbench
  123.   aufgemacht. Verlassen wird das Fenster natürlich mit dem 
  124.   ENDCLI-Befehl
  125.  
  126.   Wer wars ?
  127.   Dieses Gadget giebt Informationen über Version und Autor den Programms
  128.   aus.
  129.  
  130.   Neuer Name
  131.   Der ARP-Filerequester wird mit diesem Gadget aufgerufen, um einen neuen
  132.   Arbeitsnamen auszuwählen. Der Requester zeigt beim 1. Aufruf das
  133.   Verzeichniss, das beim Start des Programms aktuell war, an. Bei jedem
  134.   weiteren Aufruf zeigt er das Verzeichniss, in dem man sich befand, als
  135.   man den Requester zuletzt mit "OK" verließ.
  136.   Betätigt man, bei aktivem Requester, die rechte Maustaste, wird eine
  137.   Liste aller Diskdevices, sowie aller mit ASSIGN zugewiesenen Lauf-
  138.   werke gezeigt.
  139.  
  140.   Ende
  141.   Zu diesem Gadget muß eigentlich nicht viel gesagt werden. Damit
  142.   wird das Programm verlassen.
  143.  
  144.  
  145. - Fehler und Probleme
  146.  
  147.   Da es eigentlich fehlerfreie Software nicht giebt, wäre ich jedem
  148.   sehr sehr dankbar, wenn er mich irgendwie über eventuell auftretende
  149.   Fehler unterrichten könnte. (Adresse siehe unten)
  150.   Natürlich sind auch Lösungen für Probleme willkommen !
  151.   Als Belohnung ist mindestens eine kostenlose Disk mit der neuen
  152.   Version fällig !
  153.   
  154.   1.
  155.   Wenn man Compiler und Linker über "alles zusammen ..." gestartet hat
  156.   und Compiler oder Linker einen Fehler finden, läuft der CompControl
  157.   leider bis zum Start der alten Programmversion durch.
  158.   Das Problem liegt hier bei der DOS.Execute-Funktion. Diese liefert
  159.   (vielleicht auch nur bei meiner Compilerversion ??) nämlich immer
  160.   nur -1 als Rückgabewert. Ich kann also auf diesem Wege nicht
  161.   feststellen, ob eine Operation erfolgreich war oder nicht !
  162.   Falls jemand die Lösung für dieses Problem hat, wäre es gut, wenn 
  163.   er mir mal schreiben könnte.
  164.   Man sollte also "alles zusammen ..." erst einsetzen, wenn man sicher
  165.   ist, daß sich keine Fehler mehr eingeschlichen haben. (z.B. wenn
  166.   man nur ein paar Texte oder Werte geändert hat)
  167.  
  168.   2.
  169.   Wird das Programm von der WorkBench gestartet, laufen die zu startenden
  170.   Programme nicht. Der CompControl wartet darauf, daß der Rechner von der
  171.   Ausführung der Programme zurückkehrt (was er allerdings auch mit gutem
  172.   zureden, CTRL-C usw., nicht tut.
  173.   Leider habe ich keine Ahnung, woran das liegt ! Ich werde mich bis zur 
  174.   nächsten Version um eine Lösung bemühen.
  175.  
  176.  
  177. Hier ist noch die Kontaktadresse
  178. für die SoftWareArmy :
  179.  
  180. Ralf Kaiser
  181. Winckelmannstraße 1
  182. 5600 Wuppertal 2
  183.  
  184. Tel. 02 02 / 59 28 10
  185.  
  186.  
  187. oder per DFUE :
  188.  
  189. Ronsdorfer Mailbox (Zerberus-Netz)      300/1200 Baud  8N1
  190. 02 02 / 46 36 78 
  191. im MODULA-Brett   ("BRETT /MODULA *" eingeben)
  192. USERNAME   :   ALFI
  193.  
  194.